​
COUNT Billable Metric

Step-by-Step Setup When creating a COUNT-based metered feature:
  1. Navigate to Features
    • Go to Product Catalog → Features
    • Click “Add Feature”
  2. Basic Information
    • Name: “API Calls” (or descriptive name)
    • Type: Select “Metered”
  3. Event Configuration
    • Event Name: api.calls (must match your event data)
    • Aggregation Function: Count
    • Aggregation Field: Leave empty (not required for COUNT)
  4. Usage Settings
    • Usage Reset: Periodic (for monthly limits) or Cumulative
    • Unit Name: API call / API calls
  5. Save Feature

​
Calculation Example

​
Event Data

[
  {
    "event_id": "evt_001",
    "event_name": "api.calls",
    "external_customer_id": "customer_123",
    "timestamp": "2024-01-15T10:00:00Z"
  },
  {
    "event_id": "evt_002", 
    "event_name": "api.calls",
    "external_customer_id": "customer_123",
    "timestamp": "2024-01-15T10:05:00Z"
  },
  {
    "event_id": "evt_001", // Duplicate event ID
    "event_name": "api.calls",
    "external_customer_id": "customer_123", 
    "timestamp": "2024-01-15T10:10:00Z"
  }
]

​
Calculation Process

  1. Event Matching: All events with event_name = "api.calls"
  2. Deduplication: Remove duplicate event IDs
    • evt_001 (first occurrence)
    • evt_002
    • evt_001 (duplicate - ignored)
  3. Count Result: 2 (distinct events)
Result: 2 API calls

​
Use Cases

​
API Request Tracking

Perfect for: RESTful APIs, GraphQL queries, webhook calls 
{
  "event_name": "api.calls",
  "external_customer_id": "acme_corp"
}

​
File Operations

Perfect for: File uploads, downloads, processing tasks 
{
  "event_name": "file.uploads", 
  "external_customer_id": "user_456"
}

​
Transaction Counting

Perfect for: Payment transactions, database operations, user actions 
{
  "event_name": "transactions",
  "external_customer_id": "merchant_789"
}

​
Feature Usage

Perfect for: Feature activations, button clicks, page views 
{
  "event_name": "feature.usage",
  "external_customer_id": "customer_101"
}

​
When to Use COUNT

✅ Use COUNT when:
  • Tracking discrete events or actions
  • You don’t need to measure quantity/volume
  • Simple occurrence-based billing
  • High-volume event streams (best performance)

​
Next Steps